home *** CD-ROM | disk | FTP | other *** search
/ CD Ware Multimedia 1994 November / Cd Ware (Nro. 2) - Epimundo.iso / DOS / CM / TPOSDEMO.ZIP / TPOSS.DOC < prev    next >
Encoding:
Text File  |  1994-02-07  |  14.7 KB  |  260 lines

  1.                           TPOSS v3.4 Documentation
  2.                         ----------------------------
  3.                          (c) 1994 Drew Hershkowitz
  4.  
  5. -----------------------------------------------------------------------------
  6.                            
  7.                            CONTENTS OF FILE:
  8.                            -----------------
  9.         When unpacked, the following files should be present:
  10.  
  11.      TPOSS.DOC       This File!
  12.      TPOSS34.TPG     TPOSS Program File
  13.      CONVERT.TPG     TPOSS Conversion Program (UPGRADE ONLY)
  14.  
  15.      *****
  16.      NOTE:  
  17.      ***** If this is an upgrade, run the CONVERT.TPG program from the
  18.      TPOSS directory.  Make sure the VENDORS.DBF and ITEMS.DBF are in the
  19.      directory.  They will be converted, and saved as VENDORS.OLD and 
  20.      ITEMS.OLD
  21.  
  22.      TPOSS will create its own database and index files.  If this is an
  23.      upgrade, keep the VENDOR and ITEMS databases in the homepath and
  24.      TPOSS will convert them to the new file structures.
  25.  
  26. -----------------------------------------------------------------------------
  27.  
  28.                                   OVERVIEW
  29.                                   --------
  30.      TPOSS is an acronym that stands for (T)he (P)oint (O)f (S)ale (S)ystem.
  31. It is a self contained sales and marketing utility for use with TBBS and TDBS
  32. version 1.2 or higher. It allows vendors to maintain their own catalogs and
  33. has its own credit card/C.O.D. ordering system. TPOSS tracks shipping and
  34. handling charges as well as local sales tax rates. It is configurable and is
  35. printer ready, delivering a clear, concise printout of what was ordered, when,
  36. and other important info. An unlimited number of vendors is supported and each
  37. vendor can be taken on or offline at the sysop's descretion. Any type of 
  38. product or service can be sold via TPOSS, including BBS subscriptions, club
  39. memberships, lodge dues or anything else your vendors carry. 
  40.  
  41. -----------------------------------------------------------------------------
  42.  
  43.                                 INSTALLATION
  44.                                 ------------
  45.  
  46.  
  47. 1) Place these files in their own directory, preferably named TPOSS.
  48.  
  49. 2) In the SDL menu file, there should be 1 call:
  50.  
  51.         For Example:
  52.  
  53.        Entry:
  54.        Key=$ Type=200 Opt Data=c:\tbbs\tposs\TPOSS34 /Q
  55.  
  56.  
  57. 3) Run the SYSOP utility module (TPOSS /Q). Use option [C] from the
  58.    SYSOP utility. The TPOSS path needs to be entered so that the order files 
  59.    will be found without making it necessary to have the TPOSS directory 
  60.    in the TBBS PATH statement in your autoexec file.
  61.  
  62. NOTE: If the PRINT option is configured, each order will be printed
  63.       with all information that goes to the vendor.  MAKE SURE THE
  64.       PRINTER IS READY!  If not, TPOSS will simply ignore the order to  
  65.       the printer and print to the vendor's file.
  66.  
  67. -----------------------------------------------------------------------------
  68.                                 
  69.                                 
  70.                                 Using TPOSS
  71.                                 -----------
  72.  
  73.         TPOSS should be used as follows:
  74.         
  75.         Once configured and running, vendors will log in and register to be
  76.         a vendor on your BBS.  A vendor will receive a vendor ID as well as
  77.         a vendor maintenance password which he/she or anyone for that matter
  78.         may use to maintain the individual catalog.  After this process, the
  79.         vendor must be validated by the sysop, which can be done from the
  80.         SYSOP module option [V].  Once validated he/she may configure 
  81.         their personal list of products/services.
  82.  
  83.         Upon logging in and going to VENDOR MAINTENANCE, a validated vendor
  84.         may maintain item entries by adding items, deleting, editing, viewing
  85.         his/her personal catalog or even editing the vendor information.
  86.         These updates are immediately reflected in the database of items and
  87.         products which are available to the public for possible purchase.
  88.  
  89.         The vendor(s) are solely responsible for retrieving their own orders,
  90.         which is the reason that the ORDER FILE (on the vendor's maintenance
  91.         menu) is downloadable.  
  92.  
  93.         Depending on configuration, each order may be printed to any LPT port
  94.         as well as being placed in the sysop's order file, which contains
  95.         all orders as well as vendor activities re: retrieving orders.  Any
  96.         time a vendor retrieves or views his order file, an entry be placed in
  97.         to the sysop's order file.
  98.  
  99.         The VENDOR LIST module is available for users to get in direct contact
  100.         with a vendor for whatever reason he/she feels necessary.
  101.  
  102.         The ORDER module is the subsystem in which a BBS user can view and/or
  103.         order a product or service with a credit card or COD (if the vendor
  104.         specified COD as a form of payment upon registration).
  105.  
  106.         The SYSOP utility is a utility for use by any user who has access of
  107.         255.  This utility allows editing/deleting of any vendor and or
  108.         his/her items.  The utility also includes a packing routine which
  109.         can be invoked whenever necessary, at the sysop's convenience, as well
  110.         as other convenient routines.
  111.  
  112. SETUP NOTE:  Each vendor that is validated should have his/her own directory.
  113.         Directory names are VNDn where n=vendor id.  This directory would
  114.         contain ONLY description files.  See the update log below for 
  115.         naming conventions.  The newest naming standards are under the
  116.         12/4 revisions.
  117.  
  118. 11/1/93  NOTE:  *** SALES TAX UPDATE ***
  119.         To enable use of this product in areas with unusual sales tax
  120.         requirements, the following has been altered.  If the vendor and
  121.         the (billed) customer are in the SAME state, the sales tax is 
  122.         computed as follows:
  123.                 *  If the vendor is set up with a rate of "00.00" as the
  124.                    local tax, the message "Appropriate taxes will be
  125.                    added" will be displayed.  This will allow the product
  126.                    to be used in places where sales tax is computed in
  127.                    any way other than the norm.
  128.                 *  ELSE, the tax will be computed as normal.
  129.         If the vendor and customer are in DIFFERENT states, the tax will
  130.         not be computed and the message will be "Not applicable."
  131.         In most cases, intra-state sales are not taxed.
  132.         IF THE TAXING FACILITY IN ANY WAY DOES NOT SUIT VENDORS, SIMPLY
  133.         USE A RATE OF 00.00 AND THE VENDOR WILL CALCULATE ACCORDINGLY
  134.         (MANUAL).
  135.  
  136.         SysOps are advised to archive the vndsysop.txt file regularly.
  137.         Monthly archives work well for many users of TPOSS.
  138.  
  139.         NOTE: VENDOR ADVERTISEMENTS
  140.         Vendors may now have a personal full screen advertisement.  See
  141.         11/1/93 enhancements below.
  142.  
  143. UPDATE LOG:
  144.         2/12/93:   Several new options:
  145.                         50 Character Field for Vendor Names.
  146.                         Discover and AmEx credit card support.
  147.                         Implicit Deletions:  No pack routine necessary.
  148.                         Deleted items may be recalled until the time
  149.                                 the item is overwritten by a new item,
  150.                                 possibly by another vendor.  This pertains
  151.                                 to a vendor deleting his/her own items.
  152.                         Configurable labelling: The 'MAKE' and 'MODEL'
  153.                                 fields of the previous version are
  154.                                 now configurable.  They are actually only
  155.                                 seen to a person maintaining the vendor
  156.                                 catalog or actually ordering an item. 
  157.                                 In the order list, these labels are not
  158.                                 used because they vary from one vendor
  159.                                 to another.  These are defined at the
  160.                                 vendor registration or can be edited
  161.                                 at a vendor's will.
  162.                          Unvalidation of vendors: Vendors can now be
  163.                                 unvalidated or basically put on hold.
  164.                                 This is a way to temporarily disable 
  165.                                 vendors from maintaining their orders.
  166.                                 If this is invoked, a vendor's items are
  167.                                 still advertised, unless the vendor is
  168.                                 actually deleted.  These options are on the
  169.                                 SYSOP menu.
  170.         6/28/93:        Cosmetics, simplified registration scheme.
  171.         7/13/93:        Added code to avoid error if printer is off.
  172.                         Added code to delete a vendor's order file when
  173.                                 the vendor is deleted.
  174.  
  175.         11/1/93:        Version 3.0
  176.                         Extended item descriptions: now 3 lines.
  177.                         Extended Zip Code field for international use
  178.                                 to 10 characters.  Renamed it Zip/PC for
  179.                                 Postal Code, outside of US.
  180.                         Ability to disable sales tax for use with areas
  181.                                 with unusual sales tax requirements.  See
  182.                                 previous NOTE re:Sales tax.
  183.                         Added facility to scroll through Vendors.
  184.                         Ability to view an 'ad' from a vendor.
  185.                                 Vendors advertisements are called as a 
  186.                                 TYPE 1 file (ANSI if you wish) and
  187.                                 should be named "VNDn.ANS" where n=Vendor ID.
  188.                                 If the file exists, it may be viewed; 
  189.                                 otherwise, the consumer is notified that
  190.                                 the vendor has no advertisement.
  191.                         Added "Store" functionality.  Consumer is now able
  192.                                 to browse all available "Stores" (vendors)
  193.                                 and view only what the store offers.  The
  194.                                 customer can go through the same ordering
  195.                                 process.
  196.                         Lengthened Local Tax field.  New format is 99.99.
  197.         11/18/93:       Version 3.4
  198.                         SINGLE TBBS MENU CALL if you desire.
  199.                                 TPOSS not has built in menus.  If a sysop
  200.                                 wishes to call a specific vendor's "store"
  201.                                 DIRECTLY from a tbbs menu, just call 
  202.                                 TPOSS34 as follows:
  203.         NOTE: the executable is now called TPOSS34.
  204.         Key=$ Type=200 Opt Data=c:\tbbs\tposs\TPOSS34 /Q && 1
  205.                                 This will call vendor #1's store.
  206.                         Upon entry into each "store", the vendor's ad
  207.                                 (see above for file name conventions) will be
  208.                                 displayed.  This can show general info about
  209.                                 the store, or specials, etc.  THIS IS ONLY
  210.                                 VIEWABLE BY ANSI USERS!
  211.                         A new 'Business Type' field on the vendor master
  212.                                 file.  When entering TPOSS as a customer,
  213.                                 the user will see a list of store names
  214.                                 and at the right, the business type/industry.
  215.                         For a new vendor to register, user simply enters
  216.                                 TPOSS as a vendor and types NEW.  This will
  217.                                 go to the vendor registration screen.
  218.                         The SYSOP function will only show on the main menu
  219.                                 if the user access is > 254.
  220.         12/4/93:        Added TPNEWS file.  If the file TPNEWS.ANS
  221.                                 exists in the homepath TPOSS directory, it 
  222.                                 will be displayed upon normal entry into 
  223.                                 TPOSS.  It will not be displayed if directly 
  224.                                 entering a store using OptData.
  225.                         Each vendor has own directory called VNDn where
  226.                                 n=vendor id.  This is ONLY for description
  227.                                 files.  Files that include information on
  228.                                 ordering, i.e. the vendor's order file,
  229.                                 is not held in this directory.
  230.                         Moved vendor descriptions.  If the vendor is to have
  231.                                 his/her file displayed upon entry into store,
  232.                                 the file is now called OPENER.ANS in the  
  233.                                 vendor's directory.
  234.                      ** Added extended descriptions for items.  In a vendor's
  235.                                 directory, the vendor can set up an ANSI file
  236.                                 for each item, called ITEMnnnn.ANS where
  237.                                 nnnn=item number.  The file for item #1 would
  238.                                 be ITEM1.ANS.  THIS IS ONLY VIEWABLE BY
  239.                                 ANSI USERS!
  240.                         Fixed non-ANSI user add item function.
  241.                         Screen now displays 4 digit item number.
  242.                      ** TPOSS CAN NOW HAVE A DOWNLOADABLE FILE AS IT'S ITEM!
  243.                         When adding an item, if the user says 'Y' for file,
  244.                         when the order is complete the customer will be
  245.                         able to view/download the file.  Keep in mind that
  246.                         TPOSS does not detect a viewing of a file as a 
  247.                         download, so do not put text files up in a readable
  248.                         format.  If the download is unsuccessful, the sysop
  249.                         and vendor logs will say 'Download unsuccessful,
  250.                         do not charge!'  If unsuccessful, the customer will
  251.                         be asked to retry, so that there is no need to go
  252.                         through all of the billing info again.
  253.                      ** Allow for strange shipping/handling charging 
  254.                         structures.  If an item's S/H field is set to 0,
  255.                         the user sees a message "Appropriate charges will
  256.                         be added."  This allows for shipping structures
  257.                         where the first item costs more to ship than the
  258.                         next few, etc.
  259. *****************************************************************************
  260.